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INTRODUCTION 


This manual describes the facilities of the Brown University 
Interpreter (BRUIN) as it is implemented within the Cambridge 
Monitor System. 

The BRUIN language is modeled after the University of Pittsburgh 
interpretive Language (PIL). PIL was chosen as a model because 
it contains features which are highly desirable in a console 
language. Unlike a batch processing language/ BRUIN (and PIL) 
provide the user with direct man-machine interaction capabilities. 
This feature is most noticeable in error-recovery procedures. 

After BRUIN reports an error in either syntax or program logic# 
it allows the user to make corrections and continue wlthout a new 
start. Another commendable BRUIN feature Is the lack of processor 
oriented statements such as array dimensions and variable types. 

The major goal of the BRUIN designers is that BRUIN be a language 
which will allow a neophyte as well as an experienced programmer 
to expend his energies on problem-solving rather than on "program¬ 
ming". Towards this goal the syntax has been kept simple# the 
meaning of each statement clear and unambiguous. BRUIN can best 
be utilized as either a program development tool or as a small 
numeric problem-solving tool. ' 







SYNTAX NOTATION 


Throughout this manual, wherever a BRUIN statement is described that 
statement will be illustrated with a uniform system of notation. The 
ke ywords (special BRUIN words) will be in upper case. This is not a 
requirement of the language; it is merely a device to denote the 
literal occurrence of that word. Keywords, in fact, may appear in 
combinations of upper-case and lower-case letters. Braces (<>) are 
not an element of the language but are used to denote a position in a 
statement where the user must make a replacement. 




Every BRUIN statement begins with a keyword or part and step 
number.(See the section "Direct and Indirect Mode", page 19, for a 
description of the form of the the part and step number.) A statement 
is at most 80 characters in length. Each statement begins on a new 
line and cannot be continued on a second line. A statement may, but 
need not end with a period* 

Keywords, part-step numbers and user-defined elements (such as 
variables) must not be immediately adjacent to one another. They must 
be separated by a single symbol operator (e.g. + / *), specified 
punctuation (, : ;) , an assignment symbol ( = ) or a blank. There 
must not be blank spaces within keywords, part numbers and user- 
defined elements. 


Exam£le_1^^ The syntax of a form of the conditional st-atement is 
If <Boolean expression>, THEN <co[amand>; ELSE <command>. 

A correct BRUIN command then could be 

IF a = b. Then TO STep 1.5;Efcse to step 1.6. 
but_not 

IFa=b, Then TOSTep 1.5;ELse to step 1.6 



The above statement is in 
the F in the keyword IF 
TO and Step. Notice that 
combination of upper-case 


error because there is no*t a blank between 
and the variable a, and between the keywords 
the keywords IF, THEN and ELSE appear in a 
and lower-case letters. 
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also not 

I F a=5. 11,THEN TO STEP 1.5;ELSE TO STEP l.b. 

This statement is incorrect because there is a blank in tne k<:"yHord IF 
and in the constant 5.11. 



SYSTEM PROCEDURES 


Entering BRUIN 

After logging into CP and IPL'Ing CMS, type "BRUIN". The console 
will respond with the message "BRUIN READY", 


Exiting from BRUIN 

When you are finished using BRUIN/ you should dismiss the BRUIN 
Interpreter with the BRUIN command: 

CANCEL 

CANCEL does not log you off. In order to log off from the terminal/ 
thereby preventing a second party from accessing the system under 
your nutiiber and password/ type: 

CP LOGOUT ■ 

To use the terminal system again/ you must repeat the CP LOGIN 
procedure. 





INPUT CONVENTIONS 


CMS Input conventions are used for the character delete and 
line delete functions. 

However# Input characters are not converted to upper case. 




DATA ELEMENTS 




,r^ 


Const ants 




There are three types of constants: real arithmetic constant. Boolean 
constant and character string constant. 

An arit hm e ti c consta nt is written with at most 7 decimal digits with 
an optional decimal point. The constant may be immediately followed 
by the letter E (must be upper case) and a one or two digit signed or 
unsigned integer specifying an integral power of ten (scientiiic 
notation). In either form of the constant there must not be embedded 
blanks. Some examples of 'proper arithmetic constants appear below: 


12, 34567 
3567 or 3567. 

56.5E-5 meaning 56.5 x_10-5 

125E4 meaning 125 x 10* 


A constant (and results of all operations) can have a maximum 
magnitude of 7 x and a minimum non-zero magnitude of 5.4 x 10-^^. 

The B oo lean constant s are THE THUE and THE FALSE witten in upper or 
lower case letters. 

Character_string cons tant s consist of a string of characters enclosed 

in double quotes. The double quote character may not occur in a 
string constant. Some proper character string constants are: 

5” and "BROIN". The maximum length of a character string constant is 
limited by the size of the line. 
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V ariables 




The naine of a variable must be constructed accordiog to the following 
rules: 


1. The total number of characters must not exceed eight (8). 

2. The first character must be one o£'the alphabetic characters, 

3. The remaining characters may be letters or numerals. 

Upper-case letters are distinguished fro® lower-case letters iu 
variable names; therefore the variable name DET is different from tne 
name Det, 



Ex ample 2. The,foIlowinq names 


DATANAMEy B, FXY, B12C11 


vali1 BHUIM variaole 


In idiiition to the scalar varxable which denotes one item, there rs 
the subscripted variable whic-h denotes a collection of items. A 
subscripted variable is written as a variable name followed by a list 
of subscripts enclosed in parentheses. The subscripts are separated 
by commas. For esamplsp FI (1,2) could represent the first row, second 
column of a table called FI. 

The rules for subscripted variables are summarized below: 

1. Each subscript, may be an arithmetic constant, arithmetic 
variable, or an arithmetic expression. 

2. An array may have up to four subscripts. 

J. A subscript may have any value between -32767 and J2767,. but 
only the integer part is used to reference an element of the array,- 


E xa mple 3. 

z(i,3,2*^) , TABLE (Z(I,J,J) ,I*J) 

In Example 3, assume i is 1.7 and j is 2.4; becadse only the integer 
part of the subscript is used, the element referred to in the z array 
isz(1,2,4). 
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Storage Is allocated dynamically for variables (both scalar 
variables and arrays) at the time that the variable is defined 
(i.e./ assigned a value). Therefore# sparse arrays are kept 
in a reduced space. In no BRUIN statement is is possible to 
reference the whole array by using only the name; both name 
and subscript must be specified. 

to use a variable which has no associated value is an error. 

The interpreter will notify the user that this type of error 
has occurred. 

In addition to having a value# a variable has an associated data 
type. The data type may be arithmetic# Boolean# or character 
string# depending on the type of value assigned to it. To change 
the data type of a variable by assigning to it a value of a different 
data type Is an error. The interpreter will notify the user that 
this sort of error has occurred. 


OPERATORS AND .EIPRESSIONS 


Arithmet ic Expression s a nd F unctions 


The arithmetic operators of addition, subtraction, multiplication, 
division and exponentiation are represented symbolically by +, *, 
/, and ** respectively. (The vertical bar, also indicates 
exponentiation.) 


I exam ple 

I 

I 

I + addition a+b 




subtraction 

a-"b 

multiplication 

a^S'b 

division 

a/b 

exponentiation 

a**b 


Table 1. Arithmetic Operators 


Arithmetic constants and variables are combined by the ' arithmetic 
operators to form arithmetic expressions. Arithmetic expressions, in 
turn, can be bracketed by parentheses to form other arithmetic 
expressions. The order in which expressions are evaluated is governed 
by the following rules of precedence with operations of a higher 
precedence performed before those of a lower precedence. Except for 
exponentiation, unary- and unary+, where operators of the same 
priority appear in an expression, there is a left-to-right evaluation 
of the expression. Therefore A/B/C produces the^ same result as 
(A/B)/C. If two or more of the operators of exponentiation, unary-, 
unary+ appear in an arithmetic expression, the order of evaluation is 
from right to left. Thus k**-2 produces the same result as A**(-2). 
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r 


exa mple 


1 


highest functions SQRT(x) 


exponentiation, A|B|-2 

unary unary + 


multiplication a*N/y 

and division 


I lowest additj.on and z + p - 1 | 

I subtraction I 

I . I 

I___^_I 

If an expression is enclosed in parentheses, it is evaluated before 
its associated operation is performed. For example, in the expression 
c*(a + b) , a is added to b and this sura is multiplied by c. Thus 
parentheses modify the normal precedence rules. Parentheses can be 
used where there is a possibility of ambiguity. 

Another way that arithmetic expressions can be formed is by taking 
functions of other arithmetic expressions. The set of predefined 
arithmetic functions is shown in Table 2 of Appendix B. The function 
name is fixed but may be written with upper-case or lower-case 
letters. Each of the functions has one argument and returns one 
value. The argument must be enclosed in parentheses and may be an 
arithmetic expression. The expression is evaluated before the func¬ 
tion is called. Thus, if it is necessary to compute sin 2x, the BRUIN 
expression would be written SIN (2*x) 


Examples: 

Exp ression Mathem ati c al e quival ent 

c+a**8/b+5.E10 c + as/b + SxlQio 

TAN(LN (a*c)) |2 
-2**2*b 
(-2) ♦♦2*b 


tan2 (In (ac) ) 

-22b 

(-2) 2b 
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B oo lean Expressions 


n 


There are six relational operators and four Boolean operators defined 
in BRUIN. The symbolic representations of these operators and their 
definitions are found in Table 2 and Table 3. 


I sho rt fo rm lo n g f o rm 


$LT 


$LE 


$GT 

$GE 


la and b are arithmetic 


meaning 


e xa mple 


a less than b a < b 

f 

a less than or equal to b a $LE b 

a,equal b a = b 

a not equal b a $NE b 

a greater than b a $GT b 


a greater than or equal to b a $GE b 
expressions 


Table 2. Relational Operators 


The relational operators have two arithmetic expressions as operands; 
the result of such operations is a Boolean value (i.e., either true or 
false.) Thus, the expression B**2 - 4*A*C SOT 0 is an assertion that 
is either or false, or in BRUIN notation the result will be either THE 
TRUE or THE FALSE. 







- 

Boolean values or expressions may be combined with the Boolean 
operators or the two relational operators $EQ, $NE to produce a 
^ Boolean value. 


o 





1 

1 short 

_f orm 

long form 

meaninq 

example 



& 

SAND 

logical product 

a<b 

SAND c<d 



SOR 

logical sum or inclusive 

or a<b 

SOR c<d 



SNOT 

complement 

SNOT 

(a<b) 



SXOR 

.f 

exclusive or 

a<b 

SOR c<d 

U, b. 

c and 

d are arithmetic expressions 




Table 3- Boolean Operators 


The Boolean operators (sometimes called logical operators) have their 
usual meaning. Thus, if P and Q are Boolean values the expression 
P $AND Q has the value THE TRUE, if and only if both P and Q have the 
value THE TRUE. The expression P $0R Q has the value THE TRUE if 
either P or Q or both P and Q have the value THE TRUE. Whereas, P 
$XOR Q has the value THE TRUE if either P or Q but not both have the 
value THE TRUE. Finally, SNOT P has the value THE TRUE if and only if 
P has the value THE FALSE. 
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The priorities of operations for arithmetic. Boolean and relational 
operations are now given by the following list: 


highest arithmetic function 

unary +, unary $NOT 

* / 

- 

relational operations 
SAND 

lowest SOR, SXOR 


The priorities for arithmetic. Boolean and relational operators is 
similar to the priority of sucih operators in the PL/1 language but not 
the FORTRAN language. The one difference is in the operator SNOT. 
This difference becomes apparent in the expression SNOT a<b, where a 
and b have arithmetic values. Since SNOT has higher priority than the 
operator <, •an attempt to evaluate SNOT a in this expression will be 
made. BRUIN will then stop with the error message "WRONG KIND OF 
OPERAND". Simply enclosing the expression a<b in parentheses, as in 
Table 3, will result in the Boolean expression a<b being the operand 
of SNOT. 

The following example illustrates the evaluation of an expression 
according to the priority of the operators. 

-a^^b < c+2 SAND a+c=z 

This expression is evaluated as if the various parts were enclosed in 
parentheses. 


-(a**b) (c+2) 

C-(a**b))<(c+2) 
((- (a+*b))<(c+2)) 


(a+c) (z) 

(a+c) = (z) 

SAND ((a+c) = (z) ) 







Character String E xp ressions a n d Fu nctions 


There are three special operators $FC, $LC and $CON for manipulating 
character string data. An expression of the two operators $FC and $LC 
is evaluated from right to left. In addition to these special 
operators the relational operators are valid for comparing character 
string data. The comparison will be made according to the 360 
collating sequence. (i.e. blank <punctuation < a < b...<z<A<B... 
<Z<0.<9). the strings are compared character by character from left 
to right. If the strings are of different lengths the shorter string 
will be compared as if it were extended on the right with blanks. 
Notice that this implies that the character string "ab" will compare 
equal to the character string "ab ". Table 4 summarizes the valid 
character string operatorsi The concatenation operator, $C0N, may be 
written _ (underline symbol) or 1| (two vertical bars). 


o 


o 

Table 4. Character String Operators 


Examples Defi ni t io n 

N $FC S The N first characters of string S 


N’ $LC S The N last characters of string S 


S SCON P string S and P are joined in such a 
or way that the first character of P 
S||P immediately follows the last 
character of S 


S SLT P 
S SLE P 
S SEQ P 
S SNE P 
S SGT P 
S SGE P 


compare S and P character 
by character from left to right 


N has an arithmetic value 
S and P are character strings. 


Result 

a string of length 
N 


a string of length 
N 


a string with the 
length = length S 
+ length P 


a Boolean value 
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■^'There are four special functions which have a character string 
argument. They are UPPR, LOMR, LEN, AND CHAR. The function UPPR (S) 
produces a character string with alphabetic characters the upper case 
equivalent of the alphabetic characters of S. LOME(S) produces a 
character string with alphabetic characters the lower case equivalent 
of the alphabetic characters of S. LEN(S) returns an arithmetic value 
which is the number of characters in string S. CHAR(X) returns the 
character representation of the arithmetic value X. 

In a mixed expression of string operators, binary operators and 
Boolean operators the usual rules of priority as well as the 
conventions regarding left to right evaluation are observed. The 
string operators are placed in the priority table as follows: 


functions 

** unary -t- unary - SNOT 

*/ 

-s-- 

$FC $LC 
SCON 

SEQ $GE SLE SNE $GT $LT SEQ 
SAND 

SOR SXOR 


The following example will serve to illustrate the use of the string 
operators and the priority rules for string operators: 

Examp le : 

Assume that D is a character string variable which is equal 
to "PROVIDENCE, R.I." and one wishes to make every letter except P in 
Providence a lower case letter. This could be done with the 
expression 

1 SFC D scon LOWR (9 SLC 10 SFC D)SCON 6 $LC D 

This expression results in a character string of length 16 which is 
equivalent to "Providence, R.I.". 

In building character strings by concatenation one must observe a 
maximum length of 252. If this length is exceeded BRUIN will issue an 
error message to that effect. 
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DIRECT AND INDIRECT RODE 

To facilitate (aan^tnachine interaction* BRUIN provides two modes of 
operation, the desk calculator or diroct mode and the stored program 
or indirect mode. 

In the direct mode the console can be thought of as a desk calculator 
in;that the statement is executed immediately and the text of tne 
statement is not retained in memory. This mode of operation allows 
the user to evaluate expressions, store results of expressions tor 
later use, and direct the interpreter to execute a stored program. 

Errors are reported immediately in the direct mode. The user merely 
retypes the correct statement. The statement in error is not 
retained. For example. 


TYPE SIN (8*3, 14/16 

O . 

would result in a BRUIN response "MISFORMED -EXPRESSION” because of the 
missing right parenthesis. The user retypes 

tYPE SIN (8*3.14)/16 


and the res’rlt of the caiculatioii would appear as 


SIN(8*3.14)/16 = -0.7966093E-03 


The assignment statement in the direct mode 


SET L=A|2-4*A*C 


is lixetfise executed immediately, causing the variable L to be given a 
Value which could be used either in the direct mode or stored program 
mode. Notice here that the statement itself is not retained but the 
result of the calculation is retained in L. 

‘x 

o 
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In the indirect node, statements are stored and executed under prograa 
control in a sequence defined by part and step nuabers. In otner 
words, indirect statements make up a stored program. The user may go 
back, and forth between the two modes. The manner by which this is 
accomplished will be seen in later examples. 


A statement in the indirect mode is always preceded by a part and step 
number. It is this number which tells BRUIN that this is a statement 
of the indirect mode. The part and step number are each at most 3 
digits in length and are separated by a period- A blank must follow 
this number but must not be imbedded in the part-step number. The 
above TYPE statement, written in the indirect mode with part numoer 
11, step number 01, would appear as 

11.01 TYPE SIN(8*a.14)/16 


This statement is stored without being executed immediately. 

A part is a collection of oiiO or more steps with the identical part 
number. Since steps are arranged in ascending step number by tjie 
interpreter, it is not necessary to type- steps in seguential order. 
During the execution phase of that part, the statements will ue 
executed in the sorted order of step numbers in that part. 

Step numbers are treated as decimal fractions and may have any 
increment between them. For example, a part 1 could be written with 
steps 0, 1 and 999 (written with part numbers as 1-0, 1.1 and 1.999). 

This would be executed by the interpreter in the order 1.0, 1.1 auu 

1.999. If it is necessary to make an insertion, say between 
statements 1.0 and 1.1, simi)ly choose any number (e.g 1.05) between 
1.0 and 1.1. Then part 1 would consist of statements with numbers 
1.0, 1.05, 1.1, 1.999 and would be executed in that order. For sucn 

program changes it is wise to have gaps in the step sequence. 

During the execution of a program in the stored program mode, a 
sequence of BRUIN statements with the same part number are executed 
sequentially (assuming there is no transfer out of that part). Tnis 
means that a statement with the number ^.000 is not executed after the 
statement with the number 1.999, unless these parts are logiqaii^. 
connected by the user. This can be accomplished in a variety of ways. 
To give just one example, statement 1.999 could be the instruction 


1.999 TO STEP 2.000 






ASSIGNMENT STATEMENT 


SET statement 


SET <vacidble name> = <expre3sion>,<variable name> = <expression>,etc. 


The expression on the right-hand side of the assignment symbol (=) may 
be an arithmetic expression, Boolean expression or string expression. 
The type of expression will determine the data type assigned to tae 
variable. The keyword SET* is optional and may be omitted; tor 
clarity, every example in the manual will use the keyword. 

The SET statement can have a list of assignments of tne form <variaDAe 
name> = <expression>; each assignment in the list must be separated oy 
commas. If there is only one assignment in the statement, omit tne 
comma. The interpreter will maxe assignments in a list beginning witn 
the leftmost element in the list and proceeding to the right. 


Exam2le_4_. 

SET w = SI N {X+y) , c= w * X, w = w * y 


'Jsinj the most recently assigned values of x and y, the variable w is 
assigned the value of the arithmetic expression sin(x<-y). Then c is 
assigned the value of w*x, where the value of w is tae previously 
cemputed value, sin{x4' y). Finally w is given tlie newly computea 
value w*y. Variables w, ani c are iLithmotic variables uecause tney 
were given arithmetic values. 


Example _5_. 


SET BOOL = The True 


The variable ib)OL is assigned the const in t Boole dn vilue The True; 
therefore the variable BOOL is a Boolean variable. 















Exam£le_6i 

SET ray (1,1) =$NOT (2 = 2) 

The first = symbol on the left is the assignment symbol- The second = 
symbol is the relational operator. Therefore the value "false" i.s 
assigned to the subscripted variable ray(1,1). ray tnerefore is ' a 
boolean array. 


E xa mple 7. 

101.98 SET Num = "1234567890" 


The double quotes around 1234567890 cause Num to be a string variable- 
Therefore Num can be comtiined by string operations with other string 
operands. The number 101.98 designates part 101, step 98. 







SET ray(1,1)=$NOT(2=2) 

The first = symbol on the left is the assignment symbol- The second = 
symbol is the relational operator. Therefore the value ''false" xs 
assigned to the subscripted variable ray(1,1). ray therefore is ' a 
boolean array. 


E xa mple 7. 

101.98 SET Num = "1234567890” 


The double quotes around 1234567890 cause Num to be a string variable. 
Therefore Num can be comf)ined by string operations with other string 
operands. The number 101.98 designates part 101, step 98. 







SIMPLE CONSOLE INPUT-OUTPUT 


OUTPUT statements 


PUT <list of items separated by commas>* 
or 

PUT LIST <list of items separated by commas>* 

* (The keyword TYPE may be used in place of PUT) . 

An item in the output list of* the first PUT statement may be one of 
four types of elements; 

1. a variable name whose associated value is,to be written, 

2. an expression to be evaluated and written out, 

3. a character string enclosed in double quotes (") 

4. the special keywords, ALL, ALL VALUES, ALL PARTS, PART,STEP. 

The PUT LIST form of the output statement differs from the simple put 
form in that, the list of items of the PUT LIST may not contain tne 
special keywords described in 4 above. In addition, the PUT LIST 
writes the items in columns of 5 per line until the list is exhausted; 
a simple PUT writes the items one per line until the list is 
exhausted. Character strings in the PUT LIST form should not have 
more than 15 characters; only the leftmost 15 characters of a string 
are written. 


Example_8_^ 

PUT "The value of A is" , A 


Example 8 illustrates the first type of PUT statement. Each item on, 
the list will be written on a separate line. Assuming A has the value 
2, this statement will cause the two lines to be written. 


The value of A is 
A= 2.000000 

The interpreter always writes the variable name followed by the value 
in this PUT form. 
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Example 9 




PUT LIST "The value of A” ,A 

Example 9 illustrates the second form of the PUT statement, 
statement will cause the line to be written 

The value of A 2.000000 

E xample 10. 

PUT 3*SIN (3. 14159/16 + SQRT (35. 9) ) 

This statement will result in the line 

3*sin (3.14159/16 + sgrt{35.9) ) = -.2850968 

The special-purpose forms and their use are described below: 

1. To write out a copy of special parts sorted in step order 

PUT PART <part number> 

E xample : 

PUT PART 5, PART 6 

2. To write out a copy of the entire program, 

PUT ALL PARTS 

3. To list all defined variables and their current values, 

POT ALL VALUES. 

4. To list the entire program and all variables in storage, 

POT ALL. 


This 
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5, 


To write out a step/ 




PUT STEP <part and step number> 


Example.: 

PUT STEP 1.3/ STEP 50.1 

Since the typewriter Is a relatively slow device/ these features 
should be used sparingly. 


LINE statement 

The line statement causes the console typewriter 
down the page. 


Example 11. 


1.1 Put (EXP(1.5)+EXPC“1.5))/2 

1.2 Line 


1.3 Put (EXP(1.5)“EXPC-1.5))/2 
CALL PART 1 


to space one 1Ine 


In example 11/ the command LINE will produce a blank line between 
the two output lines. The output therefore will be 


(EXP(1.5)+EXP(-1.5))/2» 2.352406 

(EXP(1.5)-EXP(-1.5))/2= 2.129278 
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INPUT statements 


<part and step number> GET <list of variables separated by conimas>* 


or 

<part and step nuaber> GET LIST <list of variables separated by 
commas>* 

* (The keyword DEMAND may be used in place of GET) 


On execution of the GET statement, BHUIN requests the user to provxde 
values for the variables in the list following the keywords GET or GET 
LIST. The response by the'user may be one of four types of data: 

1. constants, 

2. an expression in terms of previously defined variables, 

3. function, 

4. any combination of the above. 


In the simple GET statement BRUIN prompts the user on each variable in 
the list by writing the variable name followed by =>; it then waits 
for a response from the user. 

E xample 12. 

1.5 GET a,b,c 

To the command GET a,b,c, the interpreter will respond with 
a=> 

The user may then type a number (e.g. 4.0) after the > symbol. Then 

the interpreter types 


b=> 


Again the user may type 3.5*a. The value 
defined; therefore the value of the product of 
assigned to b. Finally the interpreter types 


of a has already been 
3.5 and a will he 


c=> 


The user may respond with SQRT(a»b). 
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Exa mple 13. Assume that the value of i is 1 and j is 3. 

3.11 DEMAND B(i,i«-j) 

BRUIN will return the value of the subscripts with the array name 
B(1,4)=> 

On execution of the GET LIST statement, BRUIN will prompt only with a 
greater than (>) symbol. The user may then enter any number of data 
items on a line; the data items must be separated by commas. Any 
number of blanks may surround the commas. If the list is not 
satisfied after the transmission of one line of data, BRUIN will 
prompt the user for more data. If (n*-3) number of data items is 
transmitted and the list of varables only requests n items, the last 3 
data items will be ignored. 

Example_14^ Assume that A should have the value 5.1, 3 tne 

value 4.3, C the value -8x10-*, and J the value 1. 

81.05 GET LIST A,B,C,J 

On this command BRUIN will prompt once with the symbol>. The user may 
then enter on a line 

5,1, 4. 3, -8.E5, 1. 

Notice that the values are assigned to the variables from left to 
right. 

In examples 12, 13, and 14 the variables in the list were given 

arithmetic values but this need not be the case. Boolean values or 
character strings may also be read in as values. Example 15 is an 
illustration of a GET LIST statement with variable A being given an 
arithmetic value, B a Boolean value and C a character string value. 


Example 15. 

80.4 GET LIST A,B,C 

On execution of statement BO.4, BRUIN transmits the symbol >. Enter 

4.125+SgRT(3.14159), THE TRUE, "STRING” ’ • 

A variable is assigned a data type through the GET statement as well 
as the SET statement. In example 15 then, the variable A is an 
arithmetic variable, B is a Boolean variable^ and C is a string 
variable. 







CONTROL STATEMENTS 


In the preceeding sections you were shown how to refer to variable and 
constant quantities, process input and output and assign values to 
variables. In most cases a problem cannot be solved by a simple 
sequence of assignment statements and input/output statements. State¬ 
ments to permit decision making are often required. These decision 
processing statements permit the programmer to vary the order in which 
statements are executed. Such statements which provide the programmer 
with the ability to alter program flow are here called CONTROL 
statements. 

CALL sta tem e nt 


CALL PART <part number> 


The CALL statement causes a part to be executed starting with its 
lowest step number. 

Example _2^5. Assume that the following procedure to calcul¬ 

ate an expression involving input parameters X, Y, DELTAX, DELTAY is 
stored in the indirect mode. 

15.11 SET X = X ♦ DELTAX, I = Y ♦ DELTAY 
15.15 SET FXY = X ♦SI ND (Y)/COSD (X) ♦•S+X 


In order to execute the two-step procedure beginning with its first 
step (here 11) and terminating with its last step (here 15), enter the 
statement 

CALL PART 15 

Since the CALL statement is in the direct mode, it will cause 
execution of part 15 to take place immediately. Assuming that the 
variables X, Y, DELTAX and DELTAY have been defined, X, Y, and EKi 
will be assigned new values. Following the execution of a part (here 
part 15) invoked by a direct command, BRUIN will halt execution with 
the statement 




'•EXECUTION HALTED AT END OF PART 15" 

In the indirect mode, at the termination of the specified pact, 
control passes to the statement following the CALL. 
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Example 17. Assume part 25 of example 16 


2.51*CALL PART 15 
2.91 PUT X/Y/FXY 


Oo entering a CALL PART 2 in the direct mode/ the order of execution 
here will be 2.51/ 15.11/ 15.15 and 2.91. The point to observe here 
Is that control of execution is returned to the statement following 
the CALL statement (here 2.91). If no errors have been encountered/ 
execution will halt with the statement 


"EXECUTION HALTED AT END OF PART 2." 


GO statement_ 

It was stated earlier that BRUIN will stop execution of a stored 
program when an error Is encountered. The user may correct his 
error and continue execution at the point of error. This is done 
by typing in the correction and then issuing the direct command GO. 

Assume that in Example 16 X is initially 0/ DELTAX is I, DELTAY Is 1 
but that Y was not given an initial value. When the statement of 
step 15.11 is executed/ BRUIN will issue the error statement 

"ERROR AT STEP 15.11; UNDEFINED SYMBOL" 


Entering the statements 

SET Y = 1 
GO 


Will cause execution to resume by executing step 15.11 again. A 
word of caution Is necessary here. Because X was already evaluated 
as 1 before BRUIN discovered the error/ X will take on the value 
2 when execution resumes at step 15.11 

The GO command will not ca^s'6 execution to resume when BRUIN 
interrupts because of infinite loop. • 





TO statement 


There are two forms of the TO statement. One form is 


<part and step nuaber> TO PART <part number> ♦ 

♦ (In place of TO, GO TO may be used) 

This TO statement causes control to be transferred to the first 
statement in the specified part. To illustrate the difference between 
a TO statement and CALL statement Example 17 is rewritten replacing 
statement 2.51 with a TO statement. 


Exam p le 18. 

15.11 SET X=X+DELTAX,Y=Y*DELTAY 
15. 15 SET FXY=X*SIND (Y)/COSD (X) *-3*X 

2.51 TO part 15; 

2.91 Put X, Y, FXY 


On a CALL PART 2, the order of execution will be 2.51, 15.11, 15.1b. 

Control of execution is not returned to the statement following the TJ 
part 15 statement (here 2.91) as it is with a CALL. 

Another form of the TO statement is 

<part and step number> TO STEP <part and step number> * 

♦ (In place of TO, GO TO may be used) 

This TO statement causes control to be transferred to the statement 
with the specified part and step number. 


Example 19. 

15.11 SET X = X*DELTAX,Y=Y*DELTAY.. 

15.15 SET FXy=X*SlND (Y)/COSD (X) +3*X 
2.51 TO STEP 15.15 
2.91 PUT X,Y,FXY 

On a CALL PART 2, the order of execution will be 2.51, 15.15. Tnis 
form of TO permits transfer of control within a part. 

The TO statement is valid only in the indirect mode. 





IF statement 


The IF statement causes BRUIN to test a value and proceed in one oi 
two possible paths. The Boolean expression in the IF statement is tne 
value that is tested. The clauses THEN and ELSE describe the two 
possible actions. The simplest form is 

IF <Boolean expression>, THEN <command> 

It the Boolean expression here has the value true, the THEN clause is 
executed. If the expression is false the THEN clause is n ot executea. 
Execution proceeds with the statement following the IF statement. Tue 
word THEN may be omitted but not the punctuation (,). 

# 

Ex ampl e 20 . 

1.5 IF bl2-4*a*C<0, TYPE "ROOTS COMPLEX" 

1 . 6 ... 

If the expression b^-hac is less than zero, the 
executed followed by execution of statement 1.6. 
b2-4ac is greater than or equal to zero, control pa 
statement 1.6. 

The other form of IF has an ELSE clause as well as a THEN clause. 

IF <Boolean expression>, THEN <command>; ELSE <co[nmaud> 

If the Boolean expression has the value true, the THEN clause ts 
executed. If the expression is false, the ELSE clause is executea. 
The words THEN and ELSE may be omitted but not the punctuation (,;). 

Example 21 . 

3.9 SET A = x<3 $03 X>5 

3.91 IF A, TO STEP 4.0; ELSE TO STEP 4.3 

In this example A is a Boolean variable. It A has the value TRUE, 
transfer is made to step 4.0. if a has the value FALSE, transfer is 
made to step 4.3. 


TYPE command is 
If tne expression 
sses directly ta 




o 


Exam ple_ 22^ Assume that the user wished to accomplish a 

three-way branch depending on whether x is less than, equal to or 
greater than y and then’ wished to return to the statement following 
the IF statement. 


1.998 IF x<y, CALL PART 3; ELSE IF x=y, CALL PART 4; 
ELSE CALL PART 5 

1.999 

3. 1 

3.999 
4.6 

4.999 

5.998 

5.999 


In Example 22 the interpreter compares x and y. If the less than 
relationship is true, part 3 is executed beginning with step 3.1 and 
ending with 3.999; control then returns to statement 1.999 by virtue 
of the interpretation of a CALL command. If x is not less than y, the 
ELSE clause causes x to be compared with y again in an equality 
relationship. If x is equal to y, part 4 is done; otherwise part 5. 
Following both part 4 and part 5, step 1.999 is executed. 

The inte^rpreter will take any BRUIN command in the THEN, ELSE clauses 
but care must be exercised in using another IF in the THEN clause. If 
the expression is false, the interpreter looks for the command 
following the first semicolon. For example. 


SET Fxy = SIN(x-y)/X 


SET FXY = 1. 


SET FXY ,= x/C-xl 2-y|2) 


1.1 IF a>b, THEN IF Od, THEN TO STEP 1.4; ELSE TO STEP 4.2; 
ELSE TO. STEP 4.3 

is interpreted as if the statement were written 

1.1 IF a>b,. THEN IF c>d, THEN TO STEP 1.4; ELSE TO STEP '4.2 ’ 

In other words, if both a is greater than b and c is greater than d, 
branch to step 1.4; otherwise branch to step 4.2. Another way of 
writing this statement is 

1.1 IF a>b $AND^c>d, THEN TO STEP 1.4; ELSE TO STEP 4.2 
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FOR statement 




The FOR statement specifies that a command is to be repeatedly 
executed until a specified criterion is satisfied. The forms of the 
FOR statement vary in the stopping conditions and vary in the manner 
in which the values of a control variable are stated. All forms will 
take any BRUIN command except^ a TO command. 

The simplest form repeats an object command for a list of values: 


FOR <control variable> = <list of arithmetic expressions 
separated by comraas>:command>* 

♦(The keyword DO may be used in place of FOR; DO and FOR are 
equivalent). 


Exam pl e 23. 

101.5 FOR SOB = GET A(SUB) 

This statement will cause the GET command to be executed four times. 
Assuming J is 1, the interpreter will request values for A (1), A(2), 
A (4) , A (8). This statement could have been written 


101.5 FOR SUB = 1,2,4,8; GET A(SUB) 

Another form of the FOR statement specifies an initial value, 
increment and final value for the control variable. The general form 
is: 


FOR <control variable> = <initial value> BY <increment> TO 

\ 

<final value> : <command> 

Exa m pl e 24. 

101.5 FOR sub = 1 BY i TO 3*i: GET A (sub) 


Assuming i is 2, the variable sub will take on the values 1, 3, .5. In 
this form of the FOR statement, the command GET A (sub) is executed for 
the initial value. Then the control variable (here '' sub) is incre- 
' ^ mented (here by i) and compared to the final value (here 3*i). When 
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the value of the control variable is greater than the final value, the 
loop is terminated. If no increment is specified, an increment of one 
(1) is used. If the final value specified is less than the initial 
value, the command is executed once. An infinite loop can occur if an 
increment is chosen which will- cause the limit never to be reached, 
(e.g. initial value =1, increment = -2 and final value 2). 


The BY,TO form of the FOR statement may be combined with the list form 
as in the following example: 

1.1 FOR ID =0, 1, 2 BY 2 TO 8,9: CALL PART 8 

ID here takes on the values 0,1,2,4,6,8 and 9. Any number of BY,TO 
combinations may be used in the list. If BY is omitted the increment 

is assufflei to be one (1) until the TO limit is reached. 

■> 


There exist two additional FOR list forms. They are 


FOR <variable>=<initial value> BY <increment> UNTIL <Boolean 
expression>:<command> 


FOR <¥ariable>=<initial value> BY <increaent> WHILE <Boolean 
expression>:<command> 

E xampl e 25. 

FOB a=b B¥ 2 UNTIL a>z: DELETE X(a) 

The comaand DELETE I(a) will be repeated for successive values of a, 
until a is greater than z. 


Exam ple 26, 

1.6 FOR a=b BY 1 WHILE R<5: CALL PART 14 


The command, GILL PIET 14, will be repeated for a = b, b+1,...as long 
as R is less than 5. In the UNTIL and WHILE forms, if no increment is 
specified the control variable (here a) is not incremented. Care must 
be taken that the Boolean expression (R<5) in example 26 is not always 
trueo The value of R must at some time in part 14 be set greater than 
5 or am infinite loop will result. 









STOP statement 


If the user wishes to stop the execution of his program and perhaps 
check some values before continuing, he may use a STOP statement in 
the indirect mode. Assume that the following part is stored: 


1.66 SET DIS = B|2 - 4.*A*C 

1.67 Stop 

1.68 SET D = SQRT(DIS) 

1.67 TYPE (-B+D)/(2.*A) 

On the command CALL Part 1, statement 1.66 followed by statement 1.67 
will be executed. The message '’STOP AT STEP 1.67" will be issued by 
BRUIN. BRUIN will then wait for further instructions. At this point 
the user may • make changes or look at D to see if it is negative by 
typing in the direct mode. • 

PUT D 

A GO would cause the program to resume execution at statement 1.68. 


DONE statement 


<part and step nuffiber> DONE 


The DONE statement causes the interpreter to halt execution of a part 
by signalling a logical end. It differs from the STOP in that 
execution of the stored program does not stop. Execution continues as 
it would at the physical end of a part. 

The DONE statement is valid only in the indirect mode. 
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E xample 27 . 


1.5 FOR I = 1 TO 8: CALL PART 3 

3.3 SET B(I) = 0 

3.4 IF A (I) $LE 0, DONE 

3.5 SET B(I) = A(I) 

3.6 DONE 
CALL PART 1 


In Example 27 the values of A 
If the value of A (I), where I 
will be executed. If A (I) 
3.6 will not be executed. An 
by replacing step 3.4 with 


(1) through A(8) will be compared with 0. 
= 1,2,...8, is greater than 0, step 3.5 
is less than or equal to 0 steps 3.5 and 
equivalent process could be accomplished 


3.4 IF A(I) $LE 0, TO STEP 3.6 






PROGRAM CHANGES 


When BRUIN is waiting for a command, the user may enter either a 
direct or indirect statement. If a statement with a new step is 
entered, that statement will be inserted in proper sequence in a part. 
If a statement is entered using an old step number, the old statement 
will be removed and the new statement will replace it. 

DELETE statement 


If in further execution certain variables, parts or steps are no 
longer needed these may be deleted, thereby reducing storage 
requirements. 

f 

Steps, parts and variables may' be deleted selectively by statements of 
the form: 


o 


DELETE STEP <part "and step number> 

DELETE PART <part number> 

DELETE <list of variables separated by comma3> 


Examples: 

5,7 DELETE STEP 5.1 
DELETE PART 4 
DELETE X,Z(6) ,Z (1) 


After the execution of a DELETE command, for example DELETE X, the 
variable X is no longer defined and reference to it wj.ll generate an 
error report. 
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All values or parts may be deleted by the following statements: 


DELETE ALL VALUES 
DELETE ALL PARTS 

The first statement will leave the defined parts and delete aii 
variables. The second statement will leave the defined variables and 
delete all parts. 


To delete everything belonging to the user (parts and values) the 
statement 


DELETE ALL 








STORAGE REQUEST 


When a user makes a request to run a BRUIN job he is initially 
allocated a fixed amount of core. If more space than has been 
allocated is needed at some point in a job, the interpreter will send 
a message 

"NEED MORE SPACE" 

The user may free part of the fixed space allocated to him by issuing 
a form of the delete command. If this is not feasible he may request 
more space with the ALLOCATE command. 

ALLOCATE Statement 


ALLOCATE <number of,blocks(1 to 9)> 

o 

Example ; 

ALLOCATE 3 


ALLOCATE 3 requests 3 blocks of storage, each of which will hold about 
120 values. If there is insufficient core to fulfill this request, 
BRUIN will issue the message 

, "LAST N NOT ALLOCATED" 

For example, if BRUIN were unable to allocate one of the three blocks 
requested, the message would be 

"LAST 1 NOT ALLOCATED" 

The user may continue with the 2 blocks allocated. If BRUIN were 
unable to allocate any of the 3 blocks the message issued would be 

"LAST 3 NOT ALLOCATED" 

The user should request space at a later time. 

ALLOCATE may be used in the direct or indirect mode. 

O: 
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FILE MAINTENANCE 




r^ 


SAVE Statement 




The SAVE statement enables the user to save BRUIN programs and/or 
values as a file which can be loaded into core at a later time. 

The list of items to be saved may contain: 


1 . 

2 . 

3. 

4. 

5. 


names of variables/ 
the keywords ALL PARTS/ 
the keywords ALL VALUES/ 
the keyword ALL/ 

the keyword PART followed by a part number. 


The filename is a name ,of from one to eight alphabetic or numeric 
characters/ the first of, which is alphabetic. If the alphabetic 
characters in the filename are not upper case/ BRUIN makes them 
upper case. This change In name prevents a user from creating files 
which cannot be accessed or manipulated by CMS commands. 


SAVE as <filename> <1ist of I terns separated by commas> 

Example 28: 

V (1) = 0 

FOR I = 1 BY 1 WHILE l<10: SET A(I) * EXP (V(l) )/ V (I + 1) = 

V (I) + .1 

SAVE AS EXPTBL ALL VALUES 

In example 28/ the SAVE command causes the variable names and values 
of A (1) through A C9),, V Cl) through V CIO) and the final value of 
I to be saved In a file called EXPTBL BRUIN. In order to use the 
file at a later tlme^ you must use the same filename in a LOAD 
statement* 

LOAD EXPTBL 

The SAVE command will replace with the new file if a previously sayed 
file exists with the same name. 

SAVE is valid In both the direct and indirect mode. 

All files created by BRUIN have a filetype of ’’BRUIN'*. 
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LOAD Statement 


LOAD <fllename> 

The LOAD command causes a file to be loaded into thp users 
core area. If the user has defined parts or variables before 
issuing the LOAD command# the parts and variables will be merged 
with the file being loaded. Merging is done in the following 
manner; 

1. If a part or step defined in core has the same number 
as a part or step in the file# that part or step in 
core will be replaced by the part or step in the file; 
otherwise both parts and steps will be retained in core. 

2. If a variable defined in core has the same name as a 
variable defined in a file# the value of the variable 
in core will b® replaced by the value of the variable 
from the file.. 


Example 29: 


X (1) = .1 

FOR 1=1 BY 1 WHILE I <10: SET A(I)=SIN (X(l))# X(I+1)=X(I)+.4 
LOAD EXPTBL 


Assume that EXPTBL refers to the file in Example 28. Due to the 
nature of the LOAD merge# A(l) through A(9) in core will be re¬ 
placed by A(l) through A(9) from the data set EXPTBL. In addition 
the variables V(l) through V(10)# X(l) through X(10) and I will be 
defined in core. 


LOAD is valid in the direct and indirect mode. 




OTHER FEATURES 


Keywords Opera nds 


Various keyword operands such as ALL, ALL PARTS, ALL VALUES, STEP and 
PART are valid in the DELETE statement, simple PUT statement and SAVE 
statement. In addition to the above operands there are three operands 
which are acceptable in either the PUT statements or as operands in 
expressions. They are THE SIZE, THE TIME, and THE DATE. 

THE SIZE is a floating point number which 
is the number of free elements left in 
users core area. It is approximately the 
number of new values that users core area 
can still hold. « 


THE TIME is a floating point number 
which gives the time' since midnight 
in hundredths of a second. 


THE DATE is a character string value 
of the form YYDDD. YY is the 
tens and units digit of the year and 
DDD is number of the day with January 1 
as day 1. 

E xamp le; The statement 
PUT THE TIME, THE DATE 

produces two lines of output as follows: 

THE TIME= 0.5391414E+07 
THE DATE=''68220 » 







Comment S tatements 


A statement beginning with a C followed by one or more blanks 
Is accepted by BRUIN as a user comment line. To place such a 
comment In a part# write the part-step number followed by a blank 
followed by the letter C. Comment statements can be used anywhere 
In the program. (See sample program# Appendix A). 


Stopping Program Loops 


The SPACE key in addition to producing blanks serves another 
Important function In BRUIN. If a user program appears to BRUIN 
to be doing too much computing wi thout writing or reading# BRUIN 
will stop computing and interrogate you simply with a question 
mark; 

II _ H 


If the user wishes to continue at the point where BRUIN stopped 
the program# he must enter at least one blank (press the space 
bar at least once) and then press carriage return. If the user 
does not wish to continue at the point where BRUIN stopped the 
program# he may type any command. BRUIN will process that command. 



MATRIX STATEMENTS 


In order to treat doubly subscripted variables in a notation similar 
to a mathematical matrix notation, a set of matrix statements has been 
included in the BRUIN language. The matrix statements begin with the 
keyword MAT and may be used in either the direct or indirect mode. 


An mxn dimensi 
which is defined 
f rom 1 to M 
which is the res 
dimension of 1; 
matrix or scalar 
MAT instruction 
the Scalar as a 
keep the dimen 
Therefore a matr 
as the resulta 
row and column s 


onal BRUIN matrix A is a 
for all combinations of th 
and the second subscript fr 
ult of a MAT instruction 
a row vector has an explic 
which appears in a MAT ins 
s as a doubly subscripted 
simple variable. The inter 
sions of a matrix fixed 
ix which was input with row 
nt matrix 5f an arithmetic 
ize. 


subscripted variable A(M,N} 
e first subscript varying 
offi 1 to N. A column vector 
has an explicit second 
it first dimension of 1. A 
truction may appear in non 
variable or in the case or 
preter makes no attempt to 
to the original dimensions, 
size 3, column size 2 may 
operation have a different 


Matri x I nput s ta teme n ts 

There are two matrix input statements comparable to the ordinary Bruru 
input statements: 

MAT GET <niatrix name> ( <row size> , <column size> ) ♦ 

or 

MAT GET LIST <matrix name> ( <row size> , <column ,size> ) ♦ 

♦(The keyword DEMAND may be used in place of GST) 

The expression for row size and column size must be an arithmetic 
expression or arithmetic constant greater than or equal to 1. If tne 
expression is not an integer, it is truncated to the nearest integer. 

The MAT GET statement prompts the user for all elements of the matrix. 
Let m be the row size and n be the column size of matrix a; then tne 
MAT GET statement is equivalent to the non matrix BRUIN statement: ' 

FOR i=1 TO ra: FOR j=1 TO n: GET a(i,j)) 

The MAT GET list statement behaves as its non-matrix counterpart in 
that the input may be in the form of a list of elements separated by 
commas. 






The elements of the matrix must be listed row-major order; that xs, 
the value for a must be listed in the order 


a(1f1)^a{1||2)f«a«a(1^n)fa(2r1)f*««a(mfn) 

In both forms of the HAT GET statements the matrix, if previousxy 
defined, must specify a subscripted variable. The subscripted vari¬ 
able will be redefined as a matrix where the dimension of tne matrix 
will be changed to the row size and column size specified. 

Example 3 0^ 

MAT GET a (2,2) 

The interpreter will prompt with 

t 

a(1,1)=> 

The user then types the value he wishes to enter for this matrix 
element. Then the interpreter types 

a{1,2)=> 

The user responds again with a value. Similarly, the interpreter 
prompts for a (2, 1) and a (2,2). Just as in a non MAT statement, tne 
user response may be an arithmetic expression involving a previously 
defined variable. For example, the response for a(1,2) could have 
been a (1,1) ♦*2. 

Example 3 1 ; Assume that matrix B= 11 12 13 
“ 21 22 23 

To input this in a list form the command is . 

HAT GET LIST B(2,3) 

The interpreter responds with a >. The user may then input 
11,12,13^21,22,23 
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Matri x O utpu t St a tements 


MAT PUT <matrix nanie> ( <rotf size> , <column size> ) ♦ 

or 

MAT PUT LIST <matcix na[ne> { <row size> , <colu!nn size> ) ♦ 

♦(the keyword TYPE may be used in place of PUT) 

The expressions for row size and column size, give the dimension ot 
the matrix to be printed. This need not be the full dimensions of tne 
matrix. 

Let 3 be a matrix with row size m and column size n. The simple MAT 
PUT IS equivalent to the BBUIN statement: 

f * 

FOR i=l TO m; FOR j=1 TO n: PUT B(i,j) 

One element of B per line will be printed along with its 
identification. 


The MAT PUT LIST closely resembles its PUT LIST counterpart in tuat 
the output will be in columns with a maximum of 5 columns per line, 
liowever, only one matrix row is written per line. Thus, a 1x3 matrix 
is written as 3 lines with 3 entries per line. If a matrix has more 
than 5 columns the remaining elements ot the row are printed on a 
following line or lines, indented to the second column. 

Examp le 32; To oiitput the matrix of example 31, execute the 
following statement: 


MAT PUT B(2,3) 


The 


interpreter 
B (1,1) = 
B (1,2) = 
3 (1,3) = 
B(2,1) = 
b(2,2)= 
B (2,3) = 


responds with 
11.0 
12.0 
13.0 
21.0 
22.0 
23.0 
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Exa m ple 33 ; 

MAT POT LIST B (2,3) 

The output will be 

11.0 12.0 13.0 

21.0 22.0 23.0 

It is permissable to specify a smaller row sixe, j, or column size, k, 
in either MAT PUT statement than is defined for the matrix. BEUIN 
will simply output the upper right hand jxk partition of the matrix. 
Assuming the matrix B of example 34, the statement 

MAT PUT LIST B (i, 2) 

will produce the line 

11.0 12.,0 


M at ri x E xp r essions . 

A BRUIN matrix expression consists of at most on e operation. The 
operation may be addition, subtraction or multiplication of two 
matrices, multiplication of a matrix and a scalar, multiplication or a 
matrix and a vector (singly subscribed variable), or the evaluation of 
special BHUIN matrix functions. In some cases the dimensions of ttie 
matrix operands are required to fulfill certain constraints such as is 
required in conventional matrix algebra. In the case of the binary 
operations the two matrix operands are examined to insure that tue 
operation is conformable. In some of the matrix functions such as 
determinant evaluation the matrix must be square. 


Table 5 describes in detail the permissable matrix expressions; Tauie 
6 describes the available BRUIN matrix functions. 






Expression 

Definition 

Dimension of 

Dimension of 

Dimension 



A 

B 

Result 

A + B 

matrix add 

mxn 

mxn 

mxn 

A-B 

matrix subtract 

mxn 

mxn 

mxn 

k*B 

matrix multiply 

mxn 

nxk 

mxk 

A*s 

multiplication 





of a 

Qxn 


mxn 

S*A 

scalar an^d matrii^ 



V*A 


mxn 


1 xn 

A*V 


nxm 


nx 1 

Function (A) 


• 



A=3 

assignment 


mxn 

mxn 

A a nd B a re 

Bruin matrices; 

s is a constant or simple ’ 

variable; 


V is a singly subscripted variable of dimension M, 


Table 5. Matrix Expression 
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Functio n Argument 


Besult 


Dimension of result 


DET (A) 

nxn matrix A 

determinant 

(A) 

simple scalar 

INV (A) 

nxn matrix A 

inverse of 

A 

nxn 

TEA (A) 

nxn matrix A 

trace of A 


simple scalar 

TBS (A) 

nxm matrix A 

transpose of 

A 

mxn 

IDN (S) 

positive constant 

identify 


pxp 


or variable 

matrix 


where p is the 



t 


part of s 

A is a 

Bruin matrix; s is a 

constant or 

simple variable. 




Table 6, Matrix Functions 










M atrix Assignment Statements 

MAT SET <variable QaBe>=<matrix expression>,<variable Qame>=<iaatrix 
expression),etc. 

The MAT assignment statement assigns the value of the matrix expres¬ 
sion on the right hand side of the equal symbol to the variable on tne 
left. Not only does the matrix expression give the variable a value 
but defines its type (e.g. simple scalar, matrix). If the variauie 
on the left has already been defined as an arithmetic subscripted 
variable, it can be redefined as a matrix. No attempt is made in MAT 
instruction to keep the dimension of a matrix fixed. Example 37 rs 
given as an illustration of changing dimension sixes. The keyword SET 
is optional. 


Example 34; Assume ihat matrix B is a 3x2 matrix, G is a 2x2 
matrix, and R is a 2x2 matrix. The object is to compute 

MAT SET B=TaS (B) , 8I=INV (8) ,3=HI*B 
MAT B=G*B 

In example 37, according to the rule of matrix expressions, only one 
matrix operation per assignment is made. The first statement is a 
multiple SET statement with the assignments being performed from left 
to right. First the transpose of B is stored into B. The dimension 
of B is now 2x3. Secondly, the inverse of 8 is stored into 81 and the 
product of 81 and B transpose is computed. Finally, 8I*B rs 
premultiplied by Gand the result stored in B. 







SUMMARY 


For a summary of the BRUIN instruction set^ see Appendix A, 
part 1. 


A complete sample program as typed on the 2741 console appears 
as part 2 of Appendix A, 


Any comments about the organization or content of this manual 
or improvements, to the. language will be appreciated^ 







APPENDIX A 


1. Tabl 
comm and 
ALLOCATE 
CANCEL 
DELETE 

GET (DEHANDy 

CALL 

DONE 

FOE (DOJ 

GO 

IF 

LINE 
LOAD 
MAT GET 
MAT POT 
HAT SET 
SAVE 
SET 
STOP 
TO 

PUT (TIPE) 


of Instructions 
mode 

direct/indirect 
direct 

direct/indirect 
indirect 
direct/indirect 
indirect 
direct/indirect 
direct 

direct/indirect 

direct/indirect 

direct/indirect 

direct/indirect 

direct/indirect 

direct/indirect 

direct/indirect 

direct/indirect 

indirect 

indirect 

direct/indirect 








2. Sam ple PcoqgaB a,ad Outp ut 


>1.0 C sample program to solve quadratic equations 
>1.1 put "Program to Solve Quadratic Squatioas" 

>1.2 put " a*x*x*b*xvc=0" 

>1.3 for i=1 to 3: line 
>1.4 put "Enter Coefficients® 

>1.5 get d^bfC 

>1.6 set discrim=b*b-4*a*c 

>1.7 if discrim<0, then call part 2; else call part 3 
>1.8 line 

>1.9 put "Enter 0 to terminate, 1 to continue" 

>1.91 get ans , 

>1.92 if ans=1, then to step 1,.3; else if ans=0, done; to step 1.9 
>2.1 put "roots are complex" 

>3.1 set root 1= (-bvsqrt (discrim)) / (2*a) 

>3.2 set root2= (-b-sgrt (discrim))/(2*a) 

>3.3 type " ", root1,ro;ot2 

>CALL part 1 

Program to Solve Quadratic Equations 
a*x*x+b*x*c=0 


Enter Coefficients 

a=>1. 

b=>10. 

c=>-40. 


root1= 3.062255 
root2=-13.06225 

Enter 0 to terminate, 1 to contia-uife 
ans=>1. 


Enter Coefficients 

a=>1. 

b=>0. 

c=>l. 

Roots are complex 

Enter 0 to terminate1 to continue 
ans=>0. 

- EXECUTION HALTED AT END OF PART 1. 
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appendix b 


o 

1- BRg^N Character Set 


n ame 


special characte r 


blank (space bar oa console) 

equal 

plus sign 

minus sign 

asterisk 

slash 

left parenthesis 

right parenthesis 

comma • 

point or period 

semicolon 

colon 

**NOT” symbol 
••AND” symbol 
vertical bar 
’•greater than” 

’’less than” 
double quotation 
apostrophe 
dollar sign 
cent sign 
exclamation point 
percent sign 
underscore 
question mark 
pound sigh 
at sign 


♦ 

* 

/ 

{ 

) 


S 

I 

> 

< 

n 

'f 

$ 

t 

I 

% 

« 

a 






o 


2. B u ilt-In Mathem a tical Functions 


function 

value returned 

error condition 

example 






ABS 

|3t| 

- 


Abs (x) 

LN 

log (X) base e 

x<0 


Ln(3*z) 

LOG 2 

log (X) base 2 

x<0 


log2 {3*z*5) 

LOG 

log{x) base 10 

x<0 


LOG(x) 

EXP 

e to the power 

X x>174. 

6731 

EXP (5. 1) 

SQHT 

f 

square root of x . 

H 

A 

O 


sqrt(3,14/5) 

SIN 

sin (x) , X in radians 

1x!<2V* 

X pi 

sin (d*b) 

COS 

cos (X) , X in ra'dians 

Jx|<2i« 

X pi 

cos (3. 1/8) 

SIND 

sin (d) , d in degrees 

1X 1<2*« 

X 180 

sind (360/4) 

COSD 

cos (d) , d in degrees 

|x|<2** 

X 180 

COSD (360/8) 

TAN 

tani(x) , X in radians 

|x|<2se 

X pi 

TAN (3.14/4) 

TAND 

tan (d) , d in degrees 

1xf<2^* 

X 180 

TANa(a*b) 

ATAN 

arctan (X) in radians, 
“pi/2<ATAN (X) <pi/2 



ATAN (z) 

ATND 

arctan (x) in degrees, 
-90<ATAN (X) <90 



ATND(2) 

EBF 

2/rjp^EXP ("U«) du 

o 



ERF (. 8) 

EEFC 

1 - EHF(X| 

- 


ERFC (2.*x) 

SINH 

sinh(x) 

ic>174« 

6731 

SINH (3. 1*x) 
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COSH 

cosh(x) 

x>174.6731 

COSH (X) 

TANH 

tanh(x) 

- 

TAMH (Z) 

ATNH 

inverse hyperbolic 

ABS(X)<1 

atnh (X) 


tangent of x 


IP integer part of a number x - IP (3. 15679) 

sign of x times Largest integer <|x) 

FP fractional part of a number - PP (x*z) 


♦ RAHD uniformly distributed random 
numbers between 0 and 1. 

u EXP (-U) du : 


X < 0 HAND (X) 

X<2-«S2 

or 

x>57.5744 GA«A(3*X) 


♦*FACT x! where x! = x (x-1) (x-2) .., x<2-2S2 FACT (3) 

or 

x>57.5744 


♦For the first entry, x should be an odd integer. After the first 
entry x should be set equal to the previous result of the RaND 
function. 


is computed using the relationship x!=6AMA .{x«-1) 


♦♦ x! 







